home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / php / pear / docs / Net_SmartIRC / CHANGELOG next >
Encoding:
Text File  |  2004-03-24  |  12.2 KB  |  293 lines
  1. /**
  2.  * $Id: CHANGELOG,v 1.4.2.4 2003/07/22 17:19:45 meebey Exp $
  3.  * $Revision: 1.4.2.4 $
  4.  * $Author: meebey $
  5.  * $Date: 2003/07/22 17:19:45 $
  6.  */
  7.  
  8. v0.5.5:
  9. -------
  10. fixes:
  11.  - fixed a bug in _rawreceive()
  12.    messages were parsed wrong which caused problems with kick reasons.
  13.    (thx to sniper for reporting this).
  14.  - fixed bug in message()
  15.    CTCP ACTION messages had missing \001 at the end.
  16.  - fixed a bug in quit(), which caused quit messages not to be sent to the server.
  17.  - fixed reconnect() bug, it sent the channel join requests right after connect(),
  18.    and tried to join a channel without a name.
  19.  - fixes in ChannelSync code
  20.    When a user joins a channel after SmartIRC, no WHO info is updated in the user object.
  21.    Fixed wrong update of channel mode when rpl_channelmodeis received.
  22.    Fixed bug in _mode() method, which caused wrong handling of mode changes.
  23.    Topic updates are now tracked (thanks to sniper).
  24.    Fixed bug which caused fatal errors with ChannelSync enabled
  25.    (closes sf.net bug  #705269).
  26.    Fixed bug in _event_mode(), unhandled modes were stored wrong.
  27.    Fixed bug in _event_rpl_namreply(), which caused that the first char of the first nick
  28.    of a namreply got cut (closes sf.net bug #747832).
  29.  - fixed bug in _checktimer()
  30.    Which caused problems when a timehandler is unregistered.
  31.  - fixed _gettye()
  32.    It wasn't recognizing SMARTIRC_TYPE_ACTION.
  33.  - removed if(!$obj) check for newly created objects (closes PHP bug #24622),
  34.    required for PHP 4.1.2 compatibility.
  35.  
  36. changes:
  37.  - removed all irc commands from SmartIRC.php
  38.    they have now their own file (SmartIRC/irccommands.php).
  39.  - Net_SmartIRC_messagehandler class now extends Net_SmartIRC_irccommands.
  40.  - removed the 1. parameter (&$irc) of all message handlers, not needed anymore.
  41.  - renamed class Net_SmartIRC_user to Net_SmartIRC_channeluser,
  42.    added class Net_SmartIRC_ircuser.
  43.  - added prefix _event to all message handlers (needed because of class restructuring).
  44.  - tweaked filling of the ircdata objects.
  45.  - log() now checks the passed debug level bitwise.
  46.  - $data->message will be null instead of random garbage,
  47.    if the IRC message has no colon (the message part),
  48.  - All methods that depend on ChannelSync mode, checks if it's enabled.
  49.  - Optimized the usage of time() for $this->_lastrx.
  50.  - updated the URL of a SmartIRC based bot (atbs).
  51.  - _loggedin is now set to false when the socket is dead,
  52.    required for proper working  reconnect().
  53.  - on a reconnect(), the logfile won't be overwritten anymore.
  54.  - updated phpdoc tags.
  55.  - all access to the channel array now uses strtolower() for the key.
  56.  - fixed typo in function name setChannelSynching(),
  57.    now it's called setChannelSyncing() with a BC wrapper.
  58.  - removed all SMARTIRC_ prefixes for debug output.
  59.  - changed isJoined($channel) to isJoined($channel, $nickname)
  60.    for checking if the specified user is joined.
  61.  - removed "destructors", because they don't free the memory.
  62.  
  63. new:
  64.  - added isOpped() isVoiced() isBanned().
  65.  - added debug output and debug level for the messageparser.
  66.  - reconnect() uses now the channel key if one exists.
  67.  - added channel key syncing in _mode().
  68.  - when an actionhandler message regex has a leading '/' then the regex is used as it is,
  69.    this allows complex perl regex's.
  70.  - added message type SMARTIRC_TYPE_CTCP_REQUEST and SMARTIRC_CTCTP_REPLY for more advanced CTCP.
  71.  - added new log destinations SMARTIRC_NONE and SMARTIRC_BROWSEROUT
  72.    (for firendly browserouput). When the script is called from a browser,
  73.    the BROWSEROUT will automatic be used (closed sf.net bug #708155).
  74.  - added error handling for socket_select() in _rawreceive().
  75.  - added getMessage() to Net_SmartIRC_Error class.
  76.  - added debug level for ChannelSync code (SMARTIRC_DEBUG_CHANNELSYNCING).
  77.  - added filename and linenumber to debug output.
  78.  - added key property to channel class.
  79.  - added to all IRC commands optional $priority parameter with default value SMARTIRC_MEDIUM.
  80.  - added isError() for more advanced errorhandling, needed for encapsulation.
  81.  - added _isValidType() method, which checks for valid SMARTIRC_TYPE_* types.
  82.  
  83. v0.5.1
  84. ------
  85. fixes:
  86.  - major bugs in ChannelSynching fixed.
  87.  - fsocks support fixed.
  88.  - setUseSocket() method fixed.
  89.    If false was passed as parameter, it tried to load the socket extension.
  90.    Also warnings are now suppressed with @ in front of dl().
  91.  - fixed a typo in reconnect().
  92.  - missing SMARTIRC_DEBUG_CHANNELSYNCHING constant added.
  93.  
  94. changes:
  95.  - new design for HTML documentation used (PEAR template).
  96.  - moved all examples to their own directory (examples/).
  97.  - moved the documentation to docs/HTML/.
  98.  - added new file descriptions to README.
  99.  - removed not needed parts of DOCUMENTATION (most is now in the HTML version).
  100.  - updated the HTML documentation.
  101.  
  102. new:
  103.  - example5/6/7.php added.
  104.  - setAutoRetry() method added.
  105.    Autoretrying of connecting to the IRC server, is now supported.
  106.  
  107. v0.5.0
  108. ------
  109. fixes:
  110.  - fixed critical bug in the main _rawreceive() for() loop, messages were lost.
  111.  
  112. changes:
  113.  - License changed from GPL to LGPL.
  114.  - updated in all files the copyright year.
  115.  - changed documentation tags in front of all methods to the phpDocumentator compatible format.
  116.  - improved connect() errorhandling.
  117.  - changed login() parameters to $nick, $realname, $usermode = 0, $username = null, $password = null.
  118.  - changed join() parameters to $channelarray, $key = null.
  119.  - changed kick() parameters to $channel, $nicknamearray, $reason = null.
  120.  - changed listenFor() parameters to $messagetype
  121.    return value is now the result, instead the of a reference to the result parameter.
  122.  - sendbuffer has now 3 queues: high, medium and low
  123.    high sends 2 messages, then 1 of medium
  124.    low is only send if high _and_ medium is empty.
  125.  - select() call for sockets is strongly optimized
  126.  
  127. new:
  128.  - phpDocumentator package tags.
  129.  - include() for messagehandler.php (needed for the new API).
  130.  - setChannelSynching() method, for enabling the channel synching.
  131.  - setCtcpVersion() method, for changing the ctcp version reply string.
  132.  - setReceiveTimeout() method, for changing the receive timeout.
  133.  - setTransmitTimeout() method, for changing the transmit timeout.
  134.  - setAutoReconnect() method, for enabling the autoreconnect feature.
  135.  - channel variable, a reference to _channels because $object->channel("#chan")->topic is not possible in PHP4 (ZE1).
  136.  - reconnect() method, it will reconnect and also join all channels.
  137.  - channel() method, getting a reference to the channel, only if channelsynching is on.
  138.  - added ident, host, messageex and rawmessageex variables to the Net_SmartIRC_data class.
  139.  - class Net_SmartIRC_user, stores info about one user, only used if channelsynching is on.
  140.  - class Net_SmartIRC_channel, stores info about one channel, only used if channelsynching is on.
  141.  
  142. v0.4.0
  143. ------
  144. * phpSmartIRCclass.inc.php:
  145.  - fixed serious socket bug
  146.    The buffer of the socket got full because only 512 bytes were read at once,
  147.    which caused losing some IRC messages that are comming fast like the MOTD.
  148.    Now it will read 10240 bytes at once, and doesn't loose any IRC message.
  149.  - fixed sendbuffer
  150.    The sendbuffer will only be sent, when the class is fully connected and
  151.    registered on the IRC network. Before if a nickname collision happened,
  152.    all sent IRC commands from the buffer were ignored by the IRC server.
  153.  - fixed socket status
  154.    Socket handling is now compatible with PHP 4.3 dev.
  155.  - fixed $_nick
  156.    When the nickname got changed because of nickname is already in use,
  157.    $_nick  will be updated. (thanks for the hint to Andreas Streichardt).
  158.  - fixed actionhandler ids (unregister caused that the other ids were  changed).
  159.  - fixed TYPE_TOPIC to the right bitoperator value.
  160.  - added a reference to the IRC class in actionhandler callbacks
  161.    WARNING: all user writtin methods have to be changed!!
  162.    method( &$data ) _has to be changed_ to method( &$irc, &$data )
  163.    If you don't change those, your IRC scripts will _not_ work anymore!
  164.  - changed internal methodnames to _methodname
  165.  - changed sendbuffer
  166.    Now it uses configurable senddelay, instead of static 2 messages  
  167.    per second (send flood protection).
  168.  - changed TYPEs
  169.    All TYPE_* are now bitwise constants, register_actionhandler() can now
  170.    react to more than one message type.
  171.  - added TYPE_ACTION for those common /me messages.
  172.  - added timeevents   Added method register_timehandler()
  173.    unregister_timeid() and   reordertimehandler(). Those timehandler
  174.    can be used to call methods in specified intervalls, e.g. for
  175.    timeevents. Added needed class CphpSmartIRCclass_timehandler.
  176.  - moved all IRC related defines to defines.inc.php.
  177.  - changed if() elseif() structures where possible to switch() for
  178.    clearer/faster code.
  179.  - added more debug messages for actionhandler.
  180.  - added unregister_actionhandler() and unregister_actionid() method.
  181.    Also added needed reorderactionhandler(), which is called after an
  182.    unregister methods was called.
  183.  - added $data->channel to actionhandler callback.
  184.  
  185. * defines.inc.php:
  186.  - initial import. 
  187.  - now all IRC related defines are now in this file instead of
  188.    phpSmartIRCclass.inc.php.
  189.  
  190. * DOCUMENTATION:
  191.  - updated/added methods description
  192.  
  193. * example.php:
  194.  - changed user function parameter to new style ( &$irc and &$data ).
  195.  - added TYPE_NOTICE to query_test example.
  196.  
  197. v0.3.2
  198. ------
  199. * phpSmartIRCclass.inc.php:
  200.  - Replaced all quotes by single quote where possible for speedup.
  201.  - Added _disconnecttime for doing a clean IRC quit.
  202.  - Added Zend IDE style documentation for parameter variables types
  203.    and method descriptions.
  204.  - Spaces in nickname and username will be automaticly removed.
  205.  - Nicknamecollisions are automaticly detected and nickname will be
  206.    changed to nickname with 3 random numbers.
  207.  - New method nicknameuse().
  208.  - Fixed a serious fsock bug.
  209.  - Added new type TYPE_ERROR.
  210.  - Fixed wrong usage of & when calling methods with params that are
  211.    called by reference.
  212.  - Fixed a debug message "DEBUG: disconnected", now it will only
  213.    occur when debug mode is enabled.
  214.  - listen_for() will now do a quickdisconnect, for a big speedup.
  215.  - Changed logging system, now with debug levels, default is
  216.    DEBUG_NOTICE.
  217.  - Added benchmark system, now its possible to time things for doing
  218.    optimizations.
  219.  - New methods: benchmark(), benchmarktstart(), benchmarkend()
  220.    and show_benchmark() for the benchmark system
  221.  - Added microint(), for getting the microtime as float, needed for
  222.    the benchmarks.
  223.  - Added a couple of log() calls, for different debug levels.
  224.  - fsockets now runs in non blocking mode, because of broken?
  225.    getstatus for fsockets.
  226.  - Added mode() method, for chaning modes of a user or channel.
  227.  - Added op() and deop() method.  Added ban() and unban() method
  228.    (thx for diff file to Peter Petermann).
  229.  
  230. * DOCUMENTATION:
  231.  - added documentation for new logging system
  232.  - added the whole DEBUG_* list
  233.  
  234. * HOWTO:
  235.  - changed parameter description for debug()
  236.  
  237. * example.php:
  238.  - replaced all quotes by singlequotes where possible.
  239.  - fixed wrong usage of message()
  240.  
  241. * example2.php:
  242.  - replaced all quotes by singlquotes where possible.
  243.  - added benchmark test to the example
  244.  
  245. v0.3.0
  246. -----
  247. * phpSmartIRCclass.inc.php:
  248.  - added "Ping? Pong!" log message for debugging
  249.  - added real linux/windows syslog logging
  250.    to setlogdestination().
  251.  - new method listen_for() makes it possible
  252.    to show irc related information on a homepage, like how many users
  253.    on a channel are.
  254.  
  255. * HOWTO:
  256.  - added how to run/call the selfwritten bot
  257.  
  258. * DOCUMENTATION:
  259.  - added (missing) explaination for new methods
  260.  
  261. * example2.php:
  262.  - new examplefile with the new listen_for() method
  263.  
  264. v0.2.6
  265. ------
  266. * phpSmartIRCclass.inc.php:
  267.  - phpSmartIRCclass.inc renamed to
  268.    phpSmartIRCclass.inc.php because of security reasons
  269.  - changed function_exists() to get_loaded_extensions() for
  270.    checking if the PHP build has real socket support
  271.  - log() changed to create Linux style formated logs
  272.  - new methods for logging (daemon style)
  273.    log() for add log entries setlogdestination() can be STDOUT or FILE
  274.    setlogfile() sets the file
  275.  - changed received data processing in rawreceive()
  276.  
  277. * HOWTO:
  278.  - added a mini howto for using the class
  279.  
  280. * DOCUMENTATION:
  281.  - added class documentation of the project
  282.  
  283. * CREDITS:
  284.  - added credits file
  285.  
  286. v0.2.5
  287. ------
  288. - improved socket handling
  289. - bufferedsend fix
  290. - new version number system
  291. - cpu usage reduced
  292. - added changelog file
  293.